package com.jrauto.CarAppBackend.service;

import com.baomidou.mybatisplus.extension.service.IService;
import com.jrauto.CarAppBackend.model.Series;

import java.util.List;

/**
* @author huimin
* @description 针对表【series(汽车车系表)】的数据库操作Service
* @createDate 2025-06-27 10:44:05
*/
/**
 * 车系业务逻辑接口
 * 继承 IService 即可获得常见的单表操作方法
 */
public interface SeriesService extends IService<Series> {

    /**
     * 新增一个车系
     * @param series 车系实体对象
     * @return true 成功，false 失败
     */
    boolean addSeries(Series series);

    /**
     * 根据ID获取车系详情
     * @param id 车系ID
     * @return 对应的车系实体，如果不存在则返回 null
     */
    Series getSeriesById(Long id);

    /**
     * 更新车系信息
     * @param series 需要更新的车系实体，ID必须存在
     * @return true 成功，false 失败
     */
    boolean updateSeries(Series series);

    /**
     * 根据ID删除车系
     * @param id 车系ID
     * @return true 成功，false 失败
     */
    boolean deleteSeries(Long id);

    /**
     * 获取所有车系列表
     * @return 车系列表
     */
    List<Series> getAllSeries();

    /**
     * 根据品牌ID查询车系列表
     * @param brandId 品牌ID
     * @return 匹配该品牌ID的车系列表
     */
    List<Series> getSeriesByBrandId(Long brandId);



    /**
     * 根据车系名称查询车系
     * @param brand 车系英文名
     * @return 匹配的车系列表
     */
    List<Series> getSeriesByBrand(String brand);
}
